ファイルブラウザウィジット

ファイルブラウザコントロールには、編集可能テキストボックスおよびファイルブラウザウィジットと一緒に、オプションのラベルが表示されます。これらは、String 型の基本パラメータに関連付けられています。

ファイルブラウザウィジットをクリックすると、ファイルブラウザが呼び出されます。このファイルブラウザを使用して、パスおよびファイル名を指定できます。ファイルブラウザで[OK]をクリックすると、関連するテキストボックスが、選択されたパスおよびファイル名で更新されます。

これらを作成するには、PPGLayout.AddItem または PPGLayout::AddItem メソッドを、siControlFilePath コントロールタイプ列挙型とともに使用します。

var oItem = oLayout.AddItem( "ScriptFile", "Script File", siControlFilePath );

次に、ファイルブラウザウィジットの機能のいくつかについて、設定方法のヒントを示します。

使用可能な項目属性は次のとおりです。

すべてのコントロールで(また、PPGItem オブジェクトのプロパティとしても)使用可能な属性	多くのコントロールに共通の属性	ファイルブラウザコントロールに固有の属性
siUILabel siUIItems siUIType siUIWidthPercentage siUILabelPercentage siUILabelMinPixels	siUINoLabel siUIValueOnly siUIContinue siUICX siUICY siUIStyle	siUIFileFilter siUIInitialDir siUISubFolder siUIAudioFile siUIImageFile siUIOpenFile siUIFileMustExist

保存先や開くファイルを表示するには

デフォルトでは、ファイルブラウザは既存のファイルの名前と場所を表示します([開く]アクション)。しかし、ファイル名およびファイルの書き込み先の場所をユーザに指定させる必要がある場合は([保存]アクション)、siUIOpenFile 属性と siUIFileMustExist 属性を False に設定します。

oItem.SetAttribute( siUIOpenFile, false );
oItem.SetAttribute( siUIFileMustExist, false );

デフォルトのディレクトリを指定するには

ブラウザウィジットにより開始時に表示されるディレクトリを指定できます。

var path = XSIUtils.BuildPath(
	Application.InstallationPath(siFactoryPath),
	"Application", "Plugins"
);
oItem.SetAttribute( siUIInitialDir, path );

指定したパスが存在しない場合、エラーは表示されずに、汎用的な場所(Windows のデスクトップなど)が表示されます。

ファイル拡張子フィルタを指定するには

siUIFileFilter 属性を使用して、任意のファイル拡張子でファイルをフィルタできます。

var filterstring = "Script files (*.js *.vbs *.py)|*.js:*.vbs:*.py|";
filterstring += "Source files (*.cpp *.cs)|*.cpp:*.cs|";
filterstring += "Text files (*.txt *.text)|*.txt:*.text|";
filterstring += "All Files (*.*)|*.*||";
oItem.SetAttribute( siUIFileFilter, filterstring );

また、すべてのイメージタイプとオーディオタイプをカプセル化する 2 つの特別な属性があります。

oItem.SetAttribute( siUIImageFile, true );

... および ...

oItem.SetAttribute( siUIAudioFile, true );

注:

siUIFileFilter 属性に加え、siUIAudioFile と siUIImageFile 属性の設定を試みる場合、指定するとイメージフィルタのみが使用されます。指定しない場合は、オーディオフィルタのみが使用されます。指定したカスタムフィルタ文字列はすべて無視されます。

ファイル ブラウザ ウィジット

ファイルブラウザウィジット